home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).adf / arp-pro1.3 / NEW_MANUAL / FileRequest_ADDENDUM < prev    next >
Text File  |  1990-06-22  |  2KB  |  64 lines
  1.  
  2.  
  3.  
  4.      FileRequest(39.0)    ARP Programmers Manual     FileRequest(39.0)
  5.  
  6.  
  7.      ADDENDUM FOR
  8.       FileRequest -- Get filename from user
  9.  
  10.      ADDITIONS IN V1.3
  11.           The main change in the FileRequest() function for V1.3 of
  12.           ARP is the addition of of the ArpAllocFreq() call as the
  13.           preferred method to allocate and initialize the input data
  14.           structure.  Use of the ArpAllocFreq() call insures upward
  15.           compatability for future ARP releases.  If you do NOT use
  16.           ArpAllocFreq(), do not expect your calls to FileRequest to
  17.           work under V1.4 of AmigaDOS and beyond.  See "ArpAllocFreq"
  18.           for usage notes.
  19.  
  20.           The "fr_reserved2" longword field, which had been initialized
  21.           to ZERO under V1.1 of ARP, is now used to specify the Left
  22.       and TOP edge offsets desired.  If initialized to ZERO, the
  23.       file request will be displayed at the default position, but
  24.       if the application puts LeftEdge and TopEdge values into
  25.       the fr_LeftEdge and fr_TopEdge fields, the request will be
  26.       brought up at the requested position, offset by one pixel so
  27.       that (1,0) will actually position the request at (0,0).
  28.  
  29.       See "ArpBase.h" for a description of the FileRequester data
  30.       structure.  Note that the desired field is still defined as
  31.       "LONG fr_reserved2" in "arpbase.i", left as an exercise
  32.       for the assembly language programmer.
  33.  
  34.           In V1.3, the invalid return values for fr_Function() calls
  35.           has been fixed so developers can use the FRF_DoWildFunc
  36.           function call.
  37.  
  38.           Note that use of the fr_Function() calls to alter the window
  39.           using the NewWindFunc and AddGadFunc callbacks is not
  40.           guaranteed to work under V1.4 of AmigaDOS.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 9/12/89)
  64.